home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / WIN_VID / PSAMPLE.ZIP;1 / PICHELP.TXT < prev    next >
Encoding:
Text File  |  1994-01-08  |  13.1 KB  |  266 lines
  1. ////////////////////////////////////////////////////////////////////////////
  2. This software is freely distributable. copied or uploaded to communications
  3.  services so long as this notice remains at the top of this file. This 
  4.  software may not be included in whole or in part into any commercial 
  5.  package without the express written consent of Cyberdyne Systems, Inc. 
  6.  It may, however, be included in the public domain software or freely 
  7.  distributed software so long as the proper credit for the software is 
  8.  given. This software is provided as is without any guarantees or warranty. 
  9.  Although Cyberdyne Systems Inc. has attempted to find and correct any
  10.  bugs in this software, Cyberdyne Systems Inc. is not responsible for any 
  11.  damage caused by the use of the software also. Cyberdyne Systems Inc. is 
  12.  under no obligation to provide service, corrections, or upgrades to this
  13.  package.
  14.  Despite all the legal stuff above, if you do find bugs, I would like to 
  15.  hear about them.  Also, if you have any comments or questions, you may 
  16.  contact me at the following Number: 1-800-594-5454 and ask for 
  17.                             Andy Dollins. 
  18. ////////////////////////////////////////////////////////////////////////////
  19.                Picaso Version 1.0 
  20.                   for 
  21.               Microsoft Windows 3.1
  22. What is Picaso:
  23.      Picaso is a ray tracer, a ray tracer can generate photo 
  24.     quality images. How does a ray tracer work you might ask? It 
  25.         literally traces light rays from light source objects and follows 
  26.         them to see what they hit in the 3-Dimensional universe. If it hits
  27.         a object it creates another light ray, and sees what that ray hits 
  28.     and so on.... 
  29.  
  30. How to Install Picaso:
  31.     1: Create a directory for picaso (i.e. md c:\picaso).
  32.     2: If the files are compressed, uncompress them into the 
  33.         directory you created for picaso.
  34.     3: Check to see if the following files are present.
  35.         *PSAMPLE.EXE            Windows executable. 
  36.         *BWCC.DLL            Borland custom controls DLL.
  37.         COMCLR.SRF            Common color surface file
  38.         PICASO.DLT            Defaults file.
  39.         FILEHELP.TXT            File dialog help file.
  40.         LHELP.TXT            Light dialog help file.
  41.         OHELP.TXT            Options dialog help file.
  42.         PHELP.TXT            Plane dialog help file.
  43.         PICHELP.TXT            Picaso help file.
  44.         SHELP.TXT            Sphere dialog help file.
  45.         SRFHELP.TXT            Surface dialog help file.
  46.         VHELP.TXT            View port dialog help file.  
  47.         ROMAN.DIS            A sample of a picaso version 
  48.                         2.0 display file
  49.         NOTE: if the files with the astrics in front of them are
  50.               missing picaso will not run.
  51.  
  52.     4: If your not in windows then run windows.  
  53.     5: Run file manager goto the file|New select the program group 
  54.        radio button, and press enter of click on the OK button.
  55.     6: In the discription type Picaso Sample then press the TAB key.
  56.     7: In the group file field type PICASO.GRP and press enter or
  57.        the OK button.
  58.     8: With the Picaso Sample group selected (The Title bar will be highlighted.) 
  59.        goto file|new again.  
  60.     9: This time select program item, and press enter or press the OK 
  61.        button.
  62.     10: In the discription field type Picaso Sample, and press the 
  63.         TAB key. 
  64.     11: In the command line field type the path to psample.exe, then
  65.         press the TAB key.  
  66.     12: If you would like a short cut key press the key combination.
  67.     13: If you would like to select a different icon press the
  68.         Change Icon button.
  69.     14: Press enter or the OK Button.
  70.     15: For those people out there that don't have there 256 color
  71.         windows video driver installed, you must install it now. 
  72.          Please refer to your video card instructions to install the 
  73.         driver. Install the maximum amount of colors you video card and
  74.         driver can provide.  This program is a color hog. NOTE: You can
  75.         run picaso with 16 colors, The images will look terrible. Also 
  76.         the programs splash screens and about boxes will look off 
  77.         colored. also the icons will not look right to. 
  78.     16: Picaso is ready to run.
  79.     
  80. The Main Window: The main window doesn't do very much it's only function is to open 
  81.          all of the other windows of picaso. The menu commands are
  82.          listed below with a description of what they do.       
  83.  File:
  84.     New Scene: This command creates a new scene edit window and a new 
  85.            scene.
  86.     Exit: Exits the program.
  87.  View:
  88.     Image: Creates a new image viewer window. These windows are 
  89.            used to view bitmaps and display files.
  90.  Help:
  91.     Picaso Help: Opens up this help file in notepad.
  92.     About: Shows the about picaso dialog (Must See this about dialog it
  93.             could qualify for the best about dialog box award if there
  94.         was one.)
  95.  
  96. Image Viewer: This window is where you can view images that have already
  97.           been traced, or any other Windows or OS2/2.0 presentation
  98.           manager bitmap files. The menu commands are listed below. 
  99.           If the file has more colors (except 16 color windows users,
  100.           and those users with more than 256 colors) then windows 
  101.           is capable of displaying at one time. It will automatically
  102.           quantinize the image if the Auto Quantinize option is enabled
  103.           (See the options Dialog box help file for more details). 
  104.  File:
  105.     New Scene: Same as the main window's new scene command.
  106.     Open: Open a different image file for this window.
  107.     SaveAs: Save the image as a different name or type. The only types
  108.         supported now are BMP files.  In 2.0 PCX, TGA, BMP, and 
  109.         GIF file formats are supported. 
  110.     Exit: Same as the main window's exit command.
  111.  Edit:
  112.     Copy: Copy the image to the clipboard.
  113.  View:
  114.     Image: Same as the main window's view image command.
  115.     Quantinize: This will quantinize the image if it has more than 
  116.             256 colors. NOTE this command takes some time to 
  117.             execute.
  118.  
  119.  Window: You are probably already familiar with these menu command
  120.     therefore they are not explained here.
  121.  
  122.  Help: Same as the main window's help menu.
  123.  
  124. Edit Window: This is where you will spend most of the time in picaso. 
  125.          I will list the menu commands below.
  126.  File:
  127.     New Scene: The same command as the main window's new scene command.
  128.     Save Trace: Saves the trace in the bit map file format.
  129.     Save Trace as: Saves the trace with a different name.
  130.     Exit: Exits picaso.
  131.  Edit:
  132.     Copy: This command copies the traced image to the clipboard. 
  133.     Edit Selected Object: This command will edit the highlighted
  134.          object. 
  135.     Delete Selected Object: This command will delete the highlighted 
  136.             object.
  137.     View Port: This will open up the view port dialog.
  138.     Options: This will open up the options dialog.
  139.  View:
  140.     Trace: This will start ray tracing the scene.
  141.     Image: This will open up a image viewer window.
  142.     Quantinized Image: This will quantinize the traced image. The 
  143.                trace viewer must be open for this command to
  144.                work.
  145.  Add Object:
  146.     Sphere: Adds a sphere to the scene.
  147.     Plane: Adds a plane to the scene.
  148.     Light: Adds a light source to the scene.
  149.  Trace:
  150.     Pause Trace: Pauses the ray tracer if it is tracing.
  151.     Resume Trace: Resumes tracing if the ray tracer was paused.
  152.     Window:  Self explanatory.
  153.     Help: Same as the rest of the windows help menu.
  154.  
  155. Program Operation: This section explains hoe to create a scene a trace it.
  156.  
  157.  
  158. To create an image you must first open up a edit window. Now we are ready 
  159. to start adding objects.  Let's create a scene with a silver sphere in the 
  160. middle. Goto the menu Add Object now highlight the Sphere menu item. Now you 
  161. will see a Sphere dialog this is how you describe to the ray tracer how big 
  162. of a sphere you want and where to put it. Lets make this sphere radius 30 
  163. units (Radius is the distance from the center of the sphere to the outer 
  164. edge of the sphere). The sphere is already in the center of the universe
  165. by default. X location, Y location, and Z location all equal zero which is 
  166. the center of the universe. Now you can press the OK button or press enter.
  167. Now the Surface Attributes dialog box will now appear.  You will probably
  168. be baffled by it at first, but I have provided a simple way of setting the
  169. surface attributes. Find the surface list, this is a list of predefined 
  170. surfaces. Now find Silver in the list and double click on it. Now you have
  171. a silver sphere press the OK or enter button. Now lets add a floor to the 
  172. scene. To do this add a plane we will put it right under the sphere so in 
  173. the distance from the center type 30. Now tab over to Y surface normal and 
  174. type -1. Press OK or enter. Now select the White surface, and press OK. 
  175. To light up the scene we will have to add a light. Goto the Add Object menu
  176. and select the Light menu item. Now lets put the light above and in front
  177. of the sphere. To do this tab over to the Y Location and type 100. Now tab
  178. over to the Z Location and type -100, and press enter. Now the Surface 
  179. Attributes dialog will open. Lights don't have a surface but they emit 
  180. light of a certain color. Select white from the Surface list and press 
  181. enter. OK we are now ready to ray trace the scene. This operation can take 
  182. some time even on a fast machine. To trace the scene select the View menu, 
  183. and highlight the Trace menu item. (NOTE: If you have only 256 colors the
  184. image on the screen will look pretty lame until the raytracer is finished 
  185. and quantinizes the image. If it doesn't auto quantinize in the View menu
  186. select the Quantinize Image menu item. Quantinizing is a slow process the
  187. quantinizer must select the most important colors of the image, there can 
  188. be up to 16,000,000 different colors in a scene. If you had to hand pick 
  189. the colors it would take you nearly an eternity.) Now that you have this 
  190. image what can you do with it. You can save it and show it off to all your 
  191. friends, and give them a copy of the software. Or you can copy it to the 
  192. clipboard and paste it into an image you made with your favorite drawing 
  193. program. Unfortunately there is no economical printer that can print an 
  194. image with this many colors. So I omitted the print functions in this 
  195. program. However you can copy it to the clipboard and paste it into a 
  196. program that can print to get a print out of the picture you have just 
  197. traced.
  198.  
  199. Common Questions and Answers:
  200.  
  201. Question: How come all I see is black?
  202. Answer: There could be a couple of reasons for this. First there is a light
  203.     but it's in a location that will not illuminate anything in your
  204.     view. To remidy this you should put the light at -100 Z and 100 X
  205.     if you haven't modified the viewport. Second you have no objects
  206.     within your view.  
  207.  
  208. Question: How do I get a different view of a scene?
  209. Answer: To achieve a different view you must move the location of the view
  210.     port. Make sure you leave the Calculate LookAt check box checked 
  211.     or you will get undesired results.
  212.  
  213. Question: How do I speed up tracing?  
  214. Answer: There are three ways of doing this. In the options dialog box you 
  215.     can turn off certain calculations. The calculation that takes the 
  216.     most time is Reflections, if you turn of that option the ray tracer 
  217.     will operate up to 5x faster. The second way is to reduce the bitmap
  218.     size to 100 x 100 and get the scene exactly the way you
  219.     want it and then trace it at the size you like it. The third way is
  220.     to change the multi tasking times. Increase the Time spent tracing
  221.     and decrease the Rest Time this could really speed things up.  NOTE:
  222.     it is posible to almost halt windows execution completly try to
  223.     always give windows a rest time of 10 milli seconds.
  224.  
  225. Question: Why doesn't Picaso auto quantinze my images?
  226. Answer: There could be two reasons why. If you have more than 256 colors 
  227.     picaso will not auto quantinze even if you have the option checked 
  228.     in the options dialog. Second you have 256 colors and the auto 
  229.     quantinize option is not checked in the Options dialog so check it.  
  230.  
  231. Question: How come there are only two shapes in this program?
  232. Answer: If put more shapes in then you wouldn't buy the commercial version.
  233.  
  234. Question: What language was this program written in?
  235. Answer: C++, I used Borland's Turbo C++ visual for Windows. I've written 
  236.     some Windows programs with Microsoft's SDK C/C++ 7.0, but it sucks
  237.     compared to borlands Visual products.
  238.  
  239. Question: I want to learn more about ray tracing what do you recommend? 
  240. Answer: Craig Lindley's Practical Ray Tracing in C is on the top of my 
  241.     list, A GOOD READ!! This program has a lot of similarity's to 
  242.     Craig's sample program he gives in the book but I ported it to 
  243.     C++ (Much Much Cleaner Code), and written a Windows interface 
  244.     for it. 
  245.  
  246. Question: How many lines of code is this program?
  247. Answer: About 5,500 lines with 89 files. 
  248.  
  249. Question: How come there isn't more help. 
  250. Answer: I didn't want to take the fun out of experimenting with the program. Try anything, 
  251.     and everything that comes to mind.
  252.  
  253. Question: How come I can't find the commercial version in any of the 
  254.       software stores? 
  255. Answer: It will be awhile until I can get it distributed. 
  256.     If you want call the number on the splash screen, and I will be 
  257.     able to give you more information, about the commercial release.
  258.     Just ask for Andy.
  259.  
  260. Terminology:
  261. Ray Tracer: A algorithm that traces rays of light through a scene to see 
  262.         what it hits, and if any light is present at that point in 
  263.         space.
  264. Quantinize: To find the most important colors that make up an image.   
  265.  
  266.